home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / nntp < prev    next >
Encoding:
Text File  |  1996-06-19  |  10.3 KB  |  245 lines
  1.  
  2. nntp
  3.  
  4.         The 'nntp' commands control the operation of the Network News
  5.         Transfer Protocol (NNTP).  The nntp features are defined at
  6.         compile-time.  Two NNTP modules are available, "NNTP" which is an
  7.         NNTP client only, that stores news in a mailbox-compatible form,
  8.         and another, "NNTPS" which is a both an NNTP client and server,
  9.         that stores news articles in a form inaccessible to mailbox users.
  10.  
  11.         We first describe the "NNTP" nntp client features:
  12.  
  13.         nntp addserver <nntpserver_host> <interval> [<range>] [<groups>]
  14.           Add an NNTP news server to query every <interval> seconds for new
  15.           articles in the specified <groups>.
  16.  
  17.           <range> specifies the time-of-day limits when the queries will be
  18.           made, in the form hh:mm-hh:mm where start time precedes end time.
  19.  
  20.         Multiple 'nntp addserver' commands may be used to concatenate
  21.         groups (up to a maximum of 512 bytes).
  22.  
  23.              Example:  nntp add w5ddl.ampr.org 3600 18:00-06:00
  24.  
  25.  
  26.         nntp directory [ <News_spool_dir> [News_control_dir> ]
  27.           Display or set the spool directory for spooling news articles.
  28.           Default is /spool/mail.  Optionally set a new control directory.
  29.           The default control dir is /spool/news.
  30.  
  31.  
  32.         nntp directory  old=new
  33.           Establish a newsgroup name mapping, so that a newsgroup name
  34.           beginning with <old> is changed to one beginning with <new>,
  35.           which may be a null string.  To delete a mapping, use <old>==.
  36.           The mapping scan continues until the list is exhausted, in the
  37.           same order the nntp dir commands were specified.
  38.  
  39.               Example:  nntp dir  rec.radio.=
  40.                         nntp dir  amateur.=
  41.                         nntp dir  shortwave=swl
  42.                         nntp dir  equipment=eq
  43.  
  44.               will map rec.radio.amateur.policy to policy, rec.radio.swap
  45.               to swap, rec.radio.shortwave to swl, and
  46.               rec.radio.amateur.equipment to eq.
  47.  
  48.  
  49.         nntp dropserver <nntpserver_host>
  50.           Drop the specified NNTP server from the list of servers to contact.
  51.  
  52.  
  53.         nntp firstpoll [<#days>]                              Default: 5
  54.           Sets or shows the number of days of old news that is requested
  55.           in the initial poll to a new server.
  56.  
  57.  
  58.         nntp groups <group> [<group> ...]             Default: All groups
  59.           Display or set the currently set USEnet newsgroup(s).  The group
  60.           names are separated by spaces or commas.  The '*' and '!'
  61.           metacharacters (meaning 'all' and 'not' respectively) are
  62.           supported.
  63.  
  64.  
  65.         nntp kick <nntpserver_host>
  66.           Kick the local NNTP client to get in touch with the named server.
  67.  
  68.  
  69.         nntp listservers
  70.           List the currently defined servers.
  71.  
  72.  
  73.         nntp lzw <ON | off>
  74.           Turn on or off attempts to request LZW compression be used by
  75.           the server when sending articles.
  76.  
  77.  
  78.         nntp trace <level>                                     Default: 1
  79.           Sets or shows the current trace level for NNTP traffic.
  80.  
  81.           Level
  82.            0:  No tracing.
  83.            1:  Display serious errors only
  84.            2:  Display serious and transient errors
  85.            3:  Display serious and transient errors, plus session progress
  86.            4:  Display serious and transient errors, session progress and
  87.                   actual received articles
  88.            5:  Display errors.
  89.  
  90.  
  91.         nntp quiet <yes | NO>                                 Default: no
  92.           Sets or shows the current arrival-notification setting for NNTP
  93.           traffic.  The notification will include a BEL character if
  94.           "smtp quiet no" is in effect.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.         We now describe the "NNTPS" client/server commands.  Remember
  102.         that the 'start nntp' command must be used to allow the nntp server
  103.         to accept connects from other nntp clients.
  104.  
  105.  
  106.         nntp active
  107.           Displays the active file, which shows configured newsgroups.
  108.           See 'nntp create'.
  109.  
  110.  
  111.         nntp access [on | OFF]
  112.           Displays or sets whether access permissions are enforced.  When
  113.           enabled, the file /spool/news/access is scanned to determine the
  114.           access permissions for a client host.  Each line of this file has
  115.           fields of the form:         host:permissions:
  116.           where host is explicit hostname (FQDN) or starname, eg, *.aara.org
  117.           and permissions are a string of chars: R => read, P => post,
  118.           none=>deny access.  When access is turned on, hosts not mentioned
  119.           are DENIED nntp access.
  120.  
  121.  
  122.         nntp add <nntpserver_host> <interval> [<range>] [<groups>]
  123.           Add an NNTP news server to query every <interval> seconds for new
  124.           articles in the specified <groups>.  If no <groups> are specified,
  125.           all groups found in /spool/news/active are checked.
  126.  
  127.           <range> specifies the time-of-day limits when the queries will be
  128.           made, in the form hh:mm-hh:mm where start time precedes end time.
  129.  
  130.         Multiple 'nntp add' commands may be used to concatenate groups
  131.         (up to a maximum of 512 bytes).
  132.  
  133.         Example:  nntp add news.usl.edu 3600 usl.test,rec.radio.swap
  134.  
  135.  
  136.         nntp create <news.group.name> [y|n]
  137.           Updates the /spool/news/active file, which must have an entry
  138.           for each news group you wish to receive.  Choose y to permit
  139.           posting to this group, or n to deny posting.  y is assumed if
  140.           nothing is specified.  The /spool/news/pointer file is also
  141.           updated with the path to the directory which will contain the
  142.           articles.  Articles will be stored as separate files, named
  143.           by an integer corresponding to their arrival order.
  144.  
  145.  
  146.         nntp drop <nntpserver_host>
  147.           Drop the specified NNTP server from the list of servers to contact.
  148.  
  149.  
  150.         nntp dump <newsgroup> [<areaname>]
  151.           Dump all the news articles in <newsgroup> to the Jnos area
  152.           called <areaname>.  This would allow mailbox users to read news,
  153.           but no provisions are made to dump just new articles.  If
  154.           <areaname> is omitted, then <newsgroup> is used as the area name.
  155.  
  156.  
  157.         nntp firstpoll [<#days>]                              Default: 5
  158.           Sets or shows the number of days of old news that is requested
  159.           in the initial poll to a new server.
  160.  
  161.  
  162.         nntp ihave [<val>]                                Default: 0
  163.           Set or display the IHAVE nntp-protocol behaviour.
  164.           0 => IHAVE disabled (default)
  165.           1 => IHAVE reports only for newsgroups associated with serverhost
  166.           2 => IHAVE reports for all newsgroups
  167.  
  168.          The IHAVE protocol tells the server the message-ids of articles
  169.          stored here;  it is used to forward articles off this system.
  170.  
  171.  
  172.         nntp kick <nntpserver_host>
  173.           Kick the local NNTP client to get in touch with the named server.
  174.  
  175.  
  176.         nntp list
  177.           List the currently defined servers.
  178.  
  179.  
  180.         nntp lzw <ON | off>
  181.           Turn on or off attempts to request LZW compression be used by
  182.           the server when sending articles.
  183.  
  184.  
  185.         nntp post
  186.           Posts to a local newsgroup.  A session is created, and the console
  187.           user is queried for UserName (unless established by a prior 'nntp
  188.           profile' command), Newsgroup, Subject, and message body.  While
  189.           entering the msg, a line consisting of ".u" or ".r" will then
  190.           prompt for a file name, which is inserted into the article being
  191.           built.  "/EX", "***END" or "." will end the article when found alone
  192.           on a line.  When the message body is terminated, the prompt
  193.               [Send, Abort, Exit, List] 
  194.           is displayed.  Enter the first letter of the desired choice.
  195.           Note that Exit quits the post subcommand, while Abort (or Send)
  196.           allows you to post another article.
  197.  
  198.  
  199.         nntp profile {fullname|host|organization|reply|sig|user} string_value
  200.           Profile establishes values for the header fields of posts
  201.           originating here.  Options include:
  202.  
  203.           sig  path_to_signature_file
  204.           host FQDN    Defaults to our 'hostname'
  205.           fullname "First Mi. Lastname"
  206.           organ "organization name desired"
  207.           user "user name"
  208.           reply reply-to-address
  209.  
  210.  
  211.         nntp read <newsgroup> [<article_number>]
  212.           Reads the local <newsgroup>, beginning with the first unread
  213.           article unless <article_number> is also provided.  A session is
  214.           created for displaying the articles.  After each article, a
  215.           prompt "Read next/previous? (n/p/q) " allows the console user to
  216.           easily progress through the articles.
  217.  
  218.  
  219.         nntp quiet [<val>]                               Default: 0
  220.           Dispays or sets the value if the quiet behaviour flag.  Nntp will
  221.           display a message and/or beep when a new article arrives:
  222.           0 => beep only (default)
  223.           1 => beep and display msg
  224.           2 => no msg or beep
  225.  
  226.  
  227.  
  228.         NOTES:
  229.         1. See the 'expire' command for information on removing old articles.
  230.         2. The TO: addresses, when present, are stripped from article headers
  231.            by the NNTP client.  This was done to prevent loops should the
  232.            area be forwarded to another Jnos system, since the TO: address
  233.            would cause the msg to be routed back to the mail-to-news daemon.
  234.            If you want to forward an area, give the TO: address on the line
  235.            in forward.bbs that lists the area.  Example: rec.radio.swl all@swl
  236.         3. The NNTPS software includes a mail-to-news feature, such that email
  237.            with a To: address that begins with "!" is passed to the NNTPS
  238.            module.  The remainder of the To: address is interpreted as a
  239.            newsgroup name, with the name truncated at the first occurence of
  240.            one of "%@.,/", and with "!" translated to ".".  An alias is usually
  241.            used to provide this special name.  For example, to route all ALLUS
  242.            bulletins to both the allus area, and the ampr.allus newsgroup,
  243.            use the alias:  allus  allus  !ampr!allus
  244.  
  245.